AGA Toolkit '97/The AGA Toolkit '97.iso/programming/debug/calls/calls.0

Text File | 1996-09-07 | 5.5 KB | 199 lines

CALLS(1)                                                 CALLS(1)


NNAAMMEE
       calls - print out calling pattern of a C program

SSYYNNOOPPSSIISS
       calls [-aeitv] [-w n] [-f function] [-F function[/file.c]]
       [-D name[=def]] [-U name] [-I dir] [filenames]

DDEESSCCRRIIPPTTIIOONN
       _C_a_l_l_s is intended to help analyze the flow of a program by
       laying  out the functions called in a hierarchical manner.
       _C_a_l_l_s invokes the C preprocessor on  the  named  C  source
       files,  and  outputs the analyzed calling pattern to stan-
       dard output.  All filenames given will have their  calling
       sequences combined into one hierarchy.  If a filename of -
       is seen, standard input will be read.

       Functions called but not defined within  the  source  file
       are shown as:
              function

       While  functions  defined  in  the source files are listed
       with the file they are declared in in brackets, as shown:
              function [main.c] , or
              function [static in main.c]
       or if the function is not being described
              function [see also %d] , or
              function [see below]

       Recursive references are shown as:
              function <<< recursive >>>

       For example, given the file pprroogg..cc
              main() {
                   abc();
                   def();
              }
              abc() {
                   ghi();
                   jkl();
              }
              static mno() { }
              ghi() {
                   abc();
                   def();
                   mno();
              }

       Executing "calls prog.c" will produce:

                  1     main [prog.c]
                  2          abc [prog.c]
                  3               ghi [prog.c]
                  4                    abc <<< recursive >>>
                  5                    def



                              UNSUP                             1





CALLS(1)                                                 CALLS(1)


                  6                    mno [static in prog.c]
                  7               jkl
                  8          def

FFLLAAGGSS
       --aa     Normally only the  first  call  to  a  function  is
              recorded  for any given function, under this option
              all calls are recorded. This may  make  the  output
              for  some large programs very verbose and these are
              normally not needed to show the  calling  structure
              of a program.

       --ee     Normally  an index listing (-i below) does not con-
              tain the external functions called in the  program,
              under this option these are also listed.  Note this
              option also turns on the indexing option, -i.

       --ff_f_u_n_c_t_i_o_n
              The named function will be printed as the root of a
              calling tree.

       --FF_f_u_n_c_t_i_o_n
              The  named  static  function (in the given file) is
              used as the base of a calling tree, as above.  This
              allows  closer  examination of sources such as that
              of dbx(1) that have many functions  with  the  same
              name.

       --hh     Display a brief help message.

       --ii     This  option produces an index of all the functions
              declared in the  processed  files.  Optionally  all
              functions mentioned can be output; see -e above.

       --tt     This  option instructs _c_a_l_l_s not to display calling
              trees that were not explicitly  asked  for  on  the
              command  line.  Using  this  option  as well as the
              index option one can produce just  a  list  of  the
              functions declared in a file.

       --vv     Be  less verbose in the index output, do not output
              any defined functions that were not present in  any
              of  the  output trees.  Note this also turns on the
              index option.  For a list of all  functions  called
              by  'missle'  one might examine the index output of
              "calls -vt -f missle *.c".

       --ww_n    Set the max indentation width to n.  The default is
              96 columns.

       --DD_n_a_m_e

       --DD_n_a_m_e_=_d_e_f
              Define  the  _n_a_m_e  for  the  preprocessor, as if by



                              UNSUP                             2





CALLS(1)                                                 CALLS(1)


              #define.  If no definition is given,  the  name  is
              defined as 1.

       --UU_n_a_m_e Remove  any  initial definition of _n_a_m_e in the pre-
              processor.

       --II_d_i_r  Change the path for searching  for  #include  files
              whose  names  do  not  begin  with / to look in _d_i_r
              before looking in the directories on  the  standard
              list.

BBUUGGSS
       Static functions must be declared (in full) _b_e_f_o_r_e used to
       work properly.
       Output width checking is only done on the first  character
       on a new line.

AAUUTTHHOORR
       Originally  from the net. Major revisions by Kevin Brauns-
       dorf, PUCC.

SSEEEE AALLSSOO
       cpp(1), cc(1), ctags(1)


































                              UNSUP                             3